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Software Review 

TimeOut Grammar Can Improve 

Your Writing 

by Howard Katz 


I will never forget my Freshman English profes¬ 
sor’s critique of my first college paper. After set¬ 
tling down to review the document, I realized that 
more than half the writing on each page contained 
critical comments written in barely legible red ink 
by the professor...and that I had a lot to learn about 
writing. 

Over the years, I think I improved my writing. But 
I still lamented the lack of a built-in grammar 
checking program for Apple Works; a program that 
would catch my run-on sentences, my mixed tenses 
and incorrect punctuation, and my excessive use of 
the passive voice. 

Not that grammar checkers were unavailable; Sen¬ 
sible Software’s Sensible Grammar program would 
check my documents, but that meant leaving the 
AppleWorks environment, running Sensible Gram¬ 
mar, and then returning to AppleWorks. I would 
use Sensible Grammar occasionally, but going 
back and forth between the grammar checker and 
AppleWorks always dampened my enthusiasm for 
the process. 
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Now Quality Computers brings us TimeOut Gram¬ 
mar, the latest in the series of TimeOut enhance¬ 
ments for AppleWorks and the first TimeOut prod¬ 
uct developed since Quality assumed responsibility 
for these Beagle Bros enhancements. TimeOut 
Grammar checks your AppleWorks word processor 
documents for punctuation and style errors without 
leaving the AppleWorks environment. 

Problems with the Language 

It is not TimeOut Grammar’s fault, but the English 
language is tortuous to learn and use. As a result, 
English presents innumerable pitfalls for anyone 
trying to learn the language...including computers. 

To complicate matters, although writers can agree 
on the essential rules of the language, many great 
authors consciously or unconsciously violate those 
rules with spectacular results. 

Of course, grammar checkers know nothing about 
great writing. They work like sophisticated elec¬ 
tronic spelling dictionaries and compare your docu¬ 
ments to lists of frequently violated rules and 
incorrect phrases. Thus, grammar checkers might 
help you prepare a grammatically correct document 
for a college course or an error-free business letter, 
but a grammar checker is of little help to a novelist 
or poet. 

Despite the problems associated with the mechan¬ 
ics of the language and the large range of accept¬ 
able English writing styles, TimeOut Grammar 

The National AppleWorks Users Group (NAUG) is an 
association that supports AppleWorks users. NAUG pro¬ 
vides technical support and information about AppleWorks 
and enhancements to that program. Our primary means of 
communicating with members is through the monthly 
newsletter entitled the AppleWorks Forum. 
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may prove useful to writers who recognize the lim¬ 
itations of any grammar checking program. 

Requirements 

TimeOut Grammar runs under Apple Works 3.0 on 
any Apple Works-compatible computer equipped 
with at least 128K of memory and one 5.25-inch or 
3.5-inch disk drive. However, serious users will 
want a hard disk and at least 200K of unused 
AppleWorks desktop memory to avoid disk swap¬ 
ping and to speed up the program. The program’s 
design makes it practical for owners of 3.5-inch 
disk drives, but the delays and disk swapping faced 
by owners of 128K computers equipped with 5.25- 
inch disk drives makes the program cumbersome 
for all but the most occasional use. 

Installation 

Installing TimeOut Grammar is easy, especially if 
you have already installed TimeOut on your copy 
of AppleWorks. All you do is copy the file 
TO.GRAMMAR and the punctuation and usage 
subdirectories onto your TimeOut applications disk 
or subdirectory. The punctuation and usage subdi¬ 
rectories contain common stylistic and punctuation 
errors in text files that serve as the basis for Gram¬ 
mar’s comparative process. 


If you have never installed a Time- 
Out application, the in-elegantly 
printed but well-written manual 
gives the necessary instructions. 
Hard disk users and 3.5-inch disk 
users without many TimeOut 
applications will find it easy to 
copy and configure Grammar for 
their systems. However, 5.25-inch 
disk users will need to reconfigure 
TimeOut for multiple TimeOut 
application disks; Grammar needs 
116K of disk space to store both 
the application and its lists. 

How It Works 

TimeOut Grammar works by com¬ 
paring your document to its list of 
commonly-used phrases and punc¬ 
tuation errors. Since misspelled 
words will generate error mes¬ 
sages, you must first run your document through a 
spell checker. 

Grammar starts by loading as many of its lists as 
can fit into the available desktop memory in your 
system. You will want 200K of available Apple- 
Works desktop to get the best performance from 
the program. Otherwise, Grammar will load the 
lists it can fit into memory, check your document 
against those lists, load the next set of lists, and 
repeat this process until it checks the document 
against all the lists you specify. 

Grammar keeps its lists in memory. Although it 
takes 30 seconds to two minutes to load the Gram¬ 
mar files into memory for the first grammar check, 
checking additional documents proceeds quickly if 
you have enough memory in your computer. You 
can release the grammar lists from memory if you 
need additional space for your documents. 

Operation 

Using Grammar is easy. The menu-driven program 
starts by asking if you want to check the word pro¬ 
cessor document on the screen, text stored on the 
clipboard, or whether you want to edit the phrase and 
rule lists (see Figure 1 ). The clipboard option lets 
you check paragraphs and other short segments of 
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Pressing the Return Key starts the 
grammar/punctuation-checking 
process. Grammar searches your 
document and highlights any sus¬ 
pect phrase. You can then ignore 
the error, type in a replacement, 
tell Grammar to display suggested 
alternatives to the highlighted text, 
or mark the error and continue 
checking. Grammar puts brackets 
around your marked errors, labels 
each error, and adds a list of your 
errors to the end of the document. 

Grammar’s suggestions are partic¬ 
ularly helpful and make it easy to 
improve your writing (see Figure 
2). Grammar also highlights sus¬ 
pected punctuation errors and lets 
you ignore, retype, mark, or auto¬ 
matically correct the error. 

Grammar also checks and corrects 
many capitalization errors, includ¬ 
ing non-capitalized words at the 
beginning of a sentence and incor¬ 
rectly capitalized letters within a 
word. The program recognizes the 
unique capitalization of the words 
“AppleWorks”, “TimeOut”, and 
some other internally capitalized 
words. You will find yourself 
adding other words (including 
“ReportWriter”, “SuperFonts”, 
and “UltraMacros”) to the list. 

Editing the lists is easy; you 
choose “Edit” and then indicate 
what you want to change (see 
Figure 3). Grammar’s editing fea¬ 
ture lets you customize the pro¬ 
gram for your own writing style. 
Whether or not you use this fea¬ 
ture depends on how serious you 
are about your writing; serious 
text without checking the complete document. The writers will want t0 create separa te lists for differ- 

edit function lets you customize or create your own ent types of documents since not everything you 

Grammar phrase lists or change the name of existing write will conform t0 on i y one writing style, 
categories. The “Options” choice lets you limit the 

checking to grammar only or punctuation only. Creating those lists is not difficult, but is a time- 

consuming process. Switching to a new set of lists 
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involves setting up a separate subdirectory and 
reconfiguring Grammar to look for those lists. 

[Ed: NAUG will serve as a clearing house for 
your customized phrase lists; please send your 
personalized lists to “Grammar Phrase Lists ”, 
NAUG, Box 87453, Canton, Michigan 48187.] 

Concerns and Limitations 

Unfortunately, Grammar’s built-in lists cannot 
include every exception to the complex rules of the 
English language. However, a few common rules 
are curiously absent. For example. Grammar wants 
me to put double spaces after the period in “Mr.” 
and “Dr.” and accepts sentences that start with con¬ 
junctions such as “and” and “but”. I had to edit the 
exception lists to correct these oversights. 

Since replacing a phrase can cause inconsistencies 
within a sentence or paragraph, the manual sug¬ 
gests that you run your document through the 
checking procedure twice. This is true for all gram¬ 
mar checkers; the only difference is that Grammar 
tells you in the manual while other programs wait 
for you to discover this problem on your own. 

Using Grammar with long documents can be 
tedious because the program insists on flagging 
each “error” it encounters, even if you already told 
the program that the phrase or punctuation is not a 
concern in your document. That slows down the 
process as Grammar repeatedly highlights the same 
phrase or term throughout the document. For 
example, the phrase “TO.Grammar” generates both 
punctuation and faulty capitalization error mes¬ 
sages. Grammar flagged these errors ten times in 
an earlier incarnation of this document. 

Bugs 

By their very nature, grammar checkers are com¬ 
plicated programs, and TimeOut Grammar is no 
exception. Although generally stable, the program 
locks up on me occasionally, including every time 
it encounters a document that contains a Print Date 
Command. 

Documentation 

Grammar comes with a 34-page manual that covers 
installation and program usage. The manual is 


smaller and does not use the same high quality 
printing and paper used for the earlier TimeOut 
documentation. However, the writing style is easy 
to follow, and the manual contains the information 
you need to install and use the program. The manu¬ 
al also includes a helpful section with suggestions 
to improve your writing. The sub-headings in this 
section include “Passive Voice Is To Be Avoided,” 
“Avoid Cliches Like The Plague,” and “Don’t 
Overutilize Big Words,” all of which reflect the 
light-hearted presentations pioneered in the early 
Beagle manuals and continued by Quality. 

Conclusion 

Serious writers will find TimeOut Grammar a use¬ 
ful addition to their collection of AppleWorks 
accessories. Users who spend the time necessary to 
create different style-type files will find that Gram¬ 
mar can contribute significantly to their writing. 
Others will use Grammar occasionally to help them 
tame their bad writing habits and improve their 
style. Grammar’s ability to check your punctuation 
is a useful tool that you should use as often as you 
use a spell checker. 

Overall, Grammar does a good job of checking your 
documents, and the program can help improve your 
writing. But the complexities of both the program 
and the English language make the grammar check¬ 
ing process less practical than one might hope. 

[Howard Katz is a Medical Underwriter for Trav¬ 
elers Insurance Company in Western Springs, IL.] 

[Quality Computers recently announced the release 
of version 1.02 of TimeOut Grammar. This version 
handles abbreviations and the Print Date Command 
correctly, flags conjunctions at the beginning of sen¬ 
tences, and eliminates the occasional lock-up prob¬ 
lem experienced by the reviewer. NAUG members 
can upgrade to version 1.02 by returning their orig¬ 
inal disk and a self-addressed, stamped return mail¬ 
er to NAUG. We would appreciate, but do not 
require, a $1 donation to help cover the costs asso¬ 
ciated with this upgrade program. Our thanks to 
Quality Computer for providing these update disks.] 

[TimeOut Grammar costs $45.95 ($79.95 list)plus 
$3.50 s/h from NAUG ] 
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At took 250,000 people to 
bring you GS-RAM III 


Does your memory board 
do all this? 

/ Compatible with all standard GS 
hardware and software 
/ Expandable to 6 Megabytes 
/ Uses new 1Mb X 4 Chips 
y Accepts 3Mb as valid configuration 
/ Low power design 
/ Runs cool 

/ Compact, efficient design leaves 
plenty of room for slot 7 cards 
/ Fully DMA compatible 
/ No jumpers 

/ Super Hi-Res diagnostic software 
included 

/ Socketed components for easy 
upgrade 

/ Includes Apple Works 3.0 print 

buffer & multi-disk save features 
/ Made in USA 


In the last 12 years over 250,000 
Apple owners have chosen an 
Applied Engineering memory board 
to upgrade their system. We’ve 
applied our experience and 
engineering expertise to create the 
perfect memory board, GS-RAM III. 
Because of its compact, efficient 
design, GS-RAM III easily 
outperforms all other memory 
boards. It uses the new 1Mb X 4 
chips which draw less power than 
other memory chips or SIMMS. 
Because the board uses less power, 
it generates less heat, helping to 
prevent heat related failures on all of 
your expansion boards. 


components allow for easier 
upgrades and trouble-shooting 


; and g et y 

2N\b for 05 


yard of any 
A:\ -61O6O f° r 


So if you want more memory for 

DA’s, RAM drives, AppleWorks, 
Apple Works GS, HyperCard GS, 
Platinum Paint, Sonic Blaster or any 
other program, GS-RAM III is the 
obvious choice. Join the quarter of a 
million satisfied Applied Engineering 
memory board owners. Beam into 
the next generation of memory 
boards with GS-RAM III. 


To place an order or for more 
information, see your authorized fE 
dealer or call (214) 241-6060 today. 
Or send check or money order to 
Applied Engineering. MasterCard, 
Visa and C.O.D. welcomed. Texas 
residents add applicable sales tax. 


Applied Engineering* 

The Apple enhancement experts. 

A Division of /E Research Corporation 


Of course GS-RAM III is fully 
compatible with all standard 
software and hardware, including 
DMA devices. It includes our 
powerful AppleWorks 3.0 expander 
and diagnostic software. And 
because we pay attention to detail, 
GS-RAM III has no jumpers or 
soldered chips. Socketed 


3210 Beltline midiiM 

Dallas, TX 75234 JJSA 

©1992. At Research, Inc. All rights reserved. Brand and product 
names are registered trademarks of their respective holders. 

All specifications, terms and services are subject to change 
without notice or recourse. 


GS-RAM III 1Mb.$199 

GS-RAM m 2Mb.$299 

GS-RAM III 3Mb.$399 

GS-RAM EH 4Mb.$499 

Special GS-RAM III Trade-In ..$139 
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Now an 


Even Faster Apple Mgs 

by John Link 


The author assumes that you read his articles about accelerating the TransWarp GS which 
appeared in the March through May 1991 issues of the AppleWorks Forum. The techniques 
he describes are experimental; you must accept full responsibility for any changes you make 
to your system. 



T he Western Design Center (WDC) 
recently released a redesigned and 
faster version of the 65C816 chip that 
serves as the CPU for the Apple IIgs. 

WDC rates production-grade parts to 
run at 10 megahertz (MHz), compared 
to the 8 MHz maximum speed for the 
older design. Engineering samples run 
considerably faster. 

The new chips are clearly superior to 
the original design. The engineering 
sample I tested runs reliably at 12.5 
MHz without adjusting my power sup¬ 
ply beyond the normal 5.0 volts. (The 
engineering sample from the previous 
design would not run faster than 9 
MHz at 5.0 volts.) Furthermore, when I 
overdrive the new chip, both 8-bit and 16-bit 
instructions fail simultaneously, suggesting that it 
may no longer be necessary for designers to set 
“traps” that slow the execution of certain 16-bit 
instructions. 

Works with “Stock” Accelerators 

My TransWarp GS card has the factory 32K cache 
upgrade installed; that upgrade includes 35- 
nanosecond (ns) SRAMs. (My original 8K Trans¬ 
Warp GS came with 45ns SRAMs.) I did not need 
the special 3E Generic Array Logic chip (GAL) or 
other high speed GALs I described in the May 1991 
article until I pushed the chip to a full 15 MHz. 

After installing the new chip, my TransWarp GS- 
equipped system runs reliably at 13.75 MHz with 
the system voltage set to 5.5 volts. (At 5.0 volts, 
the system ran at 13.75 MHz for two hours without 


incident. After that, dial-in calls to my modem 
failed in 8-bit mode, although I could still dial out 
successfully, and all 16-bit applications worked 
reliably.) And, for the first thirty minutes after 
power up, it ran at 15 MHz (see Figure 1)\ 

I also tested the new 65C816 in a ZipGS with 32K 
of factory installed cache rated at 45ns. The results 
were essentially the same; the ZipGS worked reli¬ 
ably at 12.5 MHz at 5.0 volts and at 13.75 MHz at 
5.5 volts. 

However, the ZipGS would not boot at 15 MHz 
with the system set to 5.5 volts, nor would it boot 
at 13.75 MHz with 5.0 volts. (I believe a ZipGS 
equipped with 35ns SRAMs would boot and might 
run reliably in those configurations because the 
ZipGS places less loading on the CPU and thus 
runs cooler. However, I did not test the ZipGS with 
the faster SRAMs.) 
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— Top of long oscillator 
goes here. 


— Top of square oscillator 
goes here. 


<— Bottom of all 

oscillators go here. 


Figure 2: Oscillator Socket on ZipGS 


manufactures these units. Quality 
Computers and other mail order deal¬ 
ers stock a similar unit. You can use an 
insulated screwdriver to change the 
output from these power supplies with¬ 
out breaking the seal on the outer case. 
However, I only recommend that pro¬ 
cedure for users with the equipment 
necessary to measure the results and 
the experience to execute it safely. 

As I said in the original articles, you 
should use a system fan if you install 
any of these upgrades. 

Getting 10 MHz 

Most TransWarp GS and ZipGS own¬ 
ers should be able to achieve 10 MHz 
performance by substituting the new 
WDC engineering chip for their cur¬ 
rent part and installing a new 40 MHz 
oscillator (Digi-Key part #SE1104). I 
described how to perform these modi¬ 
fications on a TransWarp GS in the 
April 1991 issue of the AppleWorks 
Forum. 

I tested several sets of 8K 45ns 
SRAMs, and all worked well at 10 
MHz. However, I suggest that you 
install Applied’s 32K cache upgrade 
for the board; that upgrade includes 
higher performance 35ns chips which 
will make it easier to attain reliable 
operation at these faster speeds. 


Controlling the Voltage 

The amount of power available to your system 
affects its maximum speed. For example, my find¬ 
ing that the new processor operated for two hours 
at 13.75 MHz at 5.0 volts suggests that users 
should try the processor at that speed. My tests 
indicate that some machines provide as much as 
5.15 volts from their standard power supply; thus, 
the new processors might operate reliably at 13.75 
MHz in otherwise unmodified systems. 

Apple IIgs owners with Applied Engineering 
power supplies can “tweak” those units to generate 
more than 5.0 volts. Although Applied no longer 


ZipGS Details 

Modifying the ZipGS is similar, except the oscilla¬ 
tor socket is at the front of the card (see Figure 2). 

If your new oscillator comes in a metal case, mount 
the oscillator with the sharp comer in the upper left 
hand position. ZipGS owners with metal-cased 
oscillators do not need the leg extensions that I 
described for the TransWarp GS; the ZipGS 
accommodates both the long and square oscillators 
without modification. You should mount plastic- 
cased oscillators with the indent facing up toward 
the top of the ZipGS board. 
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Figure 4: Scrolling Speeds, AppleWorks GS WP 


Speed 

TransWarp GS 
w/ 32K cache* 

ZipGS 

w/ 32K cache* 

15.00 MHz 

39.0 

N/A 

13.75 MHz 

40.9 

47.7 

12.50 MHz 

45.0 

51.8 

10.00 MHz 

48.2 

56.2 

7.00 MHz 

61.2 

70.1 


* Time in seconds; lower numbers are better. 


Make certain that you put the bottom 
legs of the oscillator in the bottom¬ 
most holes in the socket. No matter 
which oscillator you install, there will 
be empty holes in the upper part of the 
socket, as shown in Figure 2. 

Some early production models of the 
ZipGS came with a soldered crystal 
and an empty oscillator socket. Owners 
of those units must clip the crystal’s 
leads to detach it from the board (see 
Figure 3). 

The ZipGS holds its processor firmly, 
and removing the chip takes some 
patience. You can use the basic prying technique 
that I described in my April 1991 article about the 
TransWarp GS, but you must be patient and care¬ 
ful. I managed to remove the processor with a bent 
paper clip. However, the best solution is to use a 
44-pin PLCC chip puller that you can get from an 
electronics supplier. 

Getting 12.5 MHz 

I achieved 12.5 MHz performance from both the 
TransWarp GS and the ZipGS simply by substitut¬ 
ing a 50 MHz oscillator (Digi-Key part # SE1108) 
for the 40 MHz unit; I did not need to increase the 
system voltage beyond the standard 5.0 volts. 
TransWarp GS owners with 45ns SRAMs must 
install the 32K cache upgrade to get the 35ns 
SRAMs that seem necessary for this level of per¬ 
formance. 

The ZipGS design lets it use fewer and slower 
SRAMs for a given cache size and operating speed. 
Thus, my Zip accelerator worked well at 12.5 MHz 
with its original 45ns parts. However, the Zip is not 
as efficient as the TransWarp GS, so the Zip accel¬ 
erator performs somewhat slower than the corre¬ 
sponding TransWarp accelerator. (See Figure 4 
which lists the time it takes to scroll through a 14- 
page AppleWorks GS word processor document 
with different processors.) 

Getting 13.75 MHz 

Both the TransWarp GS and ZipGS accelerators 
performed reliably at 13.75 MHz with the new chip. 


Whether or not you need a new power supply to 
get this performance depends on the output of your 
current unit. I suggest that you check your system 
by installing a 55 MHz oscillator (Digi-Key part # 
SE1109) and the new engineering grade 65C816 
and see what happens. If your system fails, you can 
try to obtain 13.75 MHz performance by installing 
the AE-type power supply and having a competent 
technician raise the output to 5.5 volts. TransWarp 
GS owners will need the faster SRAMs included in 
the 32K cache upgrade to achieve reliable 13.75 
MHz performance. ZipGS owners do not have to 
change any other chips on the board if they work as 
well as mine do. Otherwise, you can buy 35ns 
SRAMs for about $15 each, but you must be care¬ 
ful to get the correct size. Some versions of the 
ZipGS use wide body chips, others use the narrow 
body versions, and some ZipGS accelerators use 
both sizes. 

Getting 15 MHz 

I got my TransWarp GS to run briefly at 15 MHz by 
replacing the standard GALs with the high speed 
GALs described in my May 1991 article and by 
installing a 60 MHz oscillator (Digi-Key part # 
SE1110). Even then, I experienced problems after 
30 minutes at 5.5 volts, which is the upper limit of 
the voltage that I will run in my system. I did not 
substitute faster SRAMs because I suspected the 
processor itself was reaching the edge of its poten¬ 
tial. In addition, the TransWarp GS puts a signifi¬ 
cant load on the chip, which generates additional 
heat that degrades the upper performance limit. 

The ZipGS puts less of a load on the chip, and with 
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faster SRAMs it might perform reliably at 15 MHz. 
However, I could not get it to work at all with the 
factory supplied 45ns SRAMs. Since my scrolling 
tests revealed that a Trans Warp GS running at a 
given speed outperforms a ZipGS running 2 MHz 
faster, the possibility of attaining 1.25 MHz greater 
speed did not seem worth the effort. 

Qualifiers 

While a system fan is a necessity for any high 
speed system, the GALs and other special parts I 
described in my earlier articles do not seem neces¬ 
sary for users who are satisfied with 13.75 MHz 
performance from the new processor. However, 
you will probably need more than the standard 5.0 
volts to get 13.75 MHz operation, whether that 
comes from a standard power supply that is on the 
high side, or from a special unit. You must also 
remember that each engineering chip, accelerator 
card, and Apple IIgs computer is unique. Your 
results will probably differ from mine, especially if 
you try to get the absolute maximum speed that 
your chip, accelerator card, and system voltage can 
support. 

For these reasons, I limited my testing to the stan¬ 
dard 5.0 volts and the maximum 5.5 volts that I use 
in my own computer. My results at these two volt¬ 
ages can serve as guidelines for anyone who wants 
to modify their system. However, they are not 
absolute predictors of the performance you will get 
after making these changes. 

Real World Effects 

Although I do not regularly recalculate spreadsheets 
or sort data bases, I scroll around word processor 
documents all the time, and I do not like to wait 
when I perform this task. So I scrolled through a 
14-page AppleWorks GS document to test the real 
world differences between each level of processor 
speed. Figure 4 summarizes the results I attained 
with each accelerator. AppleWorks Classic users 
will find similar speed improvements in data base 
searching and sorting, and in spreadsheet recalcula¬ 
tions. Video performance in AppleWorks Classic is 
phenomenal. At 15 MHz I scrolled through every 
line in a 4800 line document in slightly more than 6 
seconds. 


Conclusion 

As you can see from Figure 4, doubling the speed 
of an accelerator does not halve the time it takes to 
perform an operation. For example, going from 7 
MHz to 15 MHz on a 32K TransWarp GS (a 214 
percent increase in speed) decreases scrolling time 
by 64 percent. Speeding up the ZipGS has about 
the same percentage effect, although it starts from a 
slower baseline. 

Increasing cache size to 32K remains the most cost 
effective modification you can make to your accel¬ 
erator. However, the new WDC chips now make it 
easy and inexpensive to achieve speeds greater 
than 10 MHz on your Apple IIgs. Because the 
cache and processor upgrades support each other, 
the performance gains you get by making both 
modifications will exceed the sum of each taken 
separately. Besides, it is a lot more fun to say you 
have a 13.75 MHz IIgs (why not round that off to 
14 MHz?) than to say that your computer has 32K 
of accelerator cache. 

[John Link is an AppleWorks consultant and the 
developer of SuperPatch and LockOut. Mr. Link 
has written more than 30 articles about Apple II, 
Macintosh, and NeXT computers.] 

[NAUG members can buy the new engineering- 
grade chips for $71.25 plus s/h directly from the 
manufacturer. List price for these chips is $95. 
Contact WDC’s new electronic bulletin board at 
(215) 646-7247for more information. NAUG mem¬ 
bers without modems should contact WDC at (215) 
646-3025 (voice) or (215) 646-6083 (fax) before 
ordering. Do not send checks or purchase orders 
without first contacting the company.] 

[Wester Design Center, 2166 E. Brown Road, Mesa, 
AZ 85213; (602) 962-4545; Fax: (602) 835-6442.] 

[Digi-Key Corporation, 701 Brooks Avenue South, 
P. O. Box 677, Thief River Falls, Minnesota 
56701; (800) 344-4539; Fax: (218) 681-3380. ] 

[NAUG members experimenting with different pro¬ 
cessors on TransWarp GS cards should get John 
Link’s TWGS Reporter. TWGS Reporter is a GS/OS 
CDEV that reports the characteristics of your Trans¬ 
Warp GS accelerator (see Figure 1). The TWGS 
Reporter Disk costs $6 plus $2 s/h from NAUG.] 
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UltraMacros Primer 


Converting Your Macros for Ultra 4 

by Mark Munz 


This is the first in a series of articles that will help UltraMacros users learn the new features 
of Ultra 4. The author assumes that you can create macros. NAUG members not familiar 
with UltraMacros should read Mark Munz’s book, The UltraMacros Primer, which costs 
$17.95plus $3.50 s/hfrom NAUG. 


U ltra 4 adds important features to UltraMacros 
and changes some basic elements of the Ultra- 
Macros programming language. [Ed: A brief 
description of these changes appeared in the 
review of Ultra 4 published in last month’s issue of 
the AppleWorks Forum.] These changes make 
many macros written for UltraMacros 3.x incom¬ 
patible with the new Ultra 4 program. 

To ease the transition to the new version of Ultra- 
Macros, Randy Brandt designed the program so 
that UltraMacros 3 and Ultra 4 can co-exist on the 
same AppleWorks 3.0 disk. Although you can only 
run one of these enhancements during each Apple- 
Works session, you can always quit AppleWorks 
and switch to the other version of UltraMacros. 

The ability to switch between macro enhancement 
programs lets you continue to use your current 
macros and commercial macro-based applications 
such as AlphaCheck and Euro Works while devel¬ 
opers create Ultra 4-compatible versions of their 
programs. However, you will want to convert your 
macros so they run under Ultra 4. 

Although Ultra 4 offers new commands and fea¬ 
tures, many of your current macros will prove 
compatible with the program. This article describes 
how to convert your old macros into the new Ultra 
4 format. 

This is a four-step process: 

1. Document your macros with comments. 

2. Rename all <ba-ctrl-> macros. 

3. Replace all commands not supported by Ultra 4. 

4. Re-compile and test your macros and task files. 


The Files Used by the Two Programs 

Here are the files used by the two versions of 
UltraMacros: 

UltraMacros 3.1 

Ultra 4 

ULTRA.SYSTEM 

UM4.0.SYSTEM 

TO.COMPILER 

TO.UM.COMPILER 

TO.MACRO.OPT 

TO.UM.OPTIONS 

TO.DEBUG 

I.DEBUG (an init) 


Getting Started 


You make these changes to the “source files” for 
your macros. The source files are AppleWorks 
word processor documents that contain a readable 
version of the macros. Most users keep copies of 
their macros in AppleWorks word processor docu¬ 
ments. Users who do not keep the original source 
files can use the UltraMacros compiler to re-create 
those files. 

Follow these steps to create word processor files 
that contain your macros: 

1. Launch ULTRA.SYSTEM to start the 3.x ver¬ 
sion of UltraMacros. 

2. Create a new AppleWorks word processor doc¬ 
ument called Task.xxxxxxxxxx where you 
replace the “x’s” with the name of the task file. 

3. Press Apple-Escape to display the TimeOut 
Menu and launch the Macro Compiler. 

4. Select choice #2, “Display current macro set”. 
The compiler will display the current macro set 
in the word processor file on your desktop. 

5. Issue an Apple-S command to save that file. 
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UltraMacros Primer. 



<sa-I>:<all:w=l:ba-*>! 

// <inc> command 

<sa-D>:<all:w=0:ba-*>! 

// <dec> command 

<ba-*>:<all: 

z=peek #socursor : 

// remember the cursor type 

insert : oa-e : 

// force to the overstrike cursor 

$0= MM : read : left : 

// read in the character under the cursor 

y=asc $0 : 

// get the ascii value 

if w=l then : y=y+l : 

//if w=l, increment the character value 

else y=y-l : endif : 

// otherwise decrement the character value 

if y>31 and y<127 : 

// verify that it is still a legal character 

print chr$ y : 

// print the new character 

else : right : endif : 

// otherwise skip it since it's not a real character 

if z=0 : then : oa-e : 

>! 

endif: // revert to the insert cursor if it's appropriate 



UltraMacros 3 

Ultra 4 

& "space" 

.spacebar 

& "y/n" : & “Do This" 

.menubar "Do This", "No, Yes": 

& "index" 

.els 1 : oa-Q : 

& "path" : & "/newpath" 

.setdisk "/newpath" 


6. Go to the TimeOut Menu and launch “Macro 
Options”. 

7. Press the Return Key to choose “Launch a new 
task” and select a new task file from the list that 
appears on your screen. 

8. Repeat steps #2-7 until you convert each task 
file into an AppleWorks word processor docu¬ 
ment. 

Adding Comments 

Start by adding comments that document your 
macros. Ultra 4 treats all text that follows two 
slashes as a comment. For example: 

x:<all:oa-Q:esc: // You can put anything in a comment! 
rtn:rtn>! 

Go through your macros and insert Returns to sep¬ 
arate each macro onto multiple lines. Then add 
comments to document your macros. 

Macro Names 

Since Ultra 4 does not support Both-Apple-Control 
<ba-ctrl-> macros, you should rename your <ba- 
ctrl-> macros as <sa->, <ba->, or <sa-ctrl-> macros. 


Edit the Macros 

Next, edit your macros 
to eliminate the fol¬ 
lowing commands not 
supported by Ultra 4: 

<inc> and <dec>: 
These commands 
increment and decre¬ 
ment the character 
under the cursor. 
Replace these com¬ 
mands with either the 
<sa-I> or <sa-D> 
macro and the <ba-*> 
macro listed in Figure 
1. Both <sa-I> and <sa-D> call 
<ba-*>, which duplicates the func¬ 
tion of <inc> or <dec> depending 
on the value of the variable W. You 
can assign any names to these 
macros. 

<elseoff>: Replace this command with <endif>. 

<&>: Ultra 4 replaces the ampersand command 
with dot commands which can themselves accept 
parameters. The Ultra 4 equivalents for these com¬ 
mands appear in Figure 2.1 will describe the syn¬ 
tax of the various dot commands in a later article in 
this series. 

<ifkey>: Ultra 4 does not support <ifkey>, which 
requires the user to press a designated key. Figure 
3 demonstrates how to use <peek $C000> in place 
of <ifkey> in your Ultra 4 macros. 

<getvar> and <putvar>: Ultra 4 does not store 
numeric and string variables in sets and does not 
offer <getvar> and <putvar> commands. See the 
section entitled “Managing Variables” below for 
information about how to convert the <getvar> and 
<putvar> commands for Ultra 4. 

<cls>: Replaced by the dot command “.els value”. 
Replace <cls> with c.cls 1>. The “1” signifies 
clearing the normal area. I will describe the syntax 
of the <.cls> and other dot commands in a later 
article in this series. 

<id#>: Replaced by the dot command “.id”. 

Change <x= id#> to <x = .id>. 
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Figure 3: Converting UltraMacros 3’s <ifkey> 


UltraMacros 3 Ultra 4 

x:<all:ifkey rtn then print "Return was pressed">! -► x:<all: z=peek $C000: if z= 13 then print "Return was pressed">! 

y:<all:ifkey>A<then print "Letter A was pressed">!-► y:<all: z=peek $C000: if z=#‘A' then print "Letter A was pressed">! 


Figure 4: Converting UltraMacros 3’s <menu> Command 

These macros create four-item menus starting at 
the first highlighted item. 

location x=5, y=5 with double spacing and with item #2 as 

UltraMacros 3 


Ultra 4 

X:<all: 


x:<all: 

poke #menufirst,2: 

{ make item #2 first highlighted} 

$1 = "Item 1": 

poke #menuinc,2 : 

{ double-spacing } 

$2 = "Item 2": 

poke #menuhor,5 : 

{ x=5 } 

$3 = "Item 3": 

z=5 : 

{ y=5 } 

$4 = "Item 4": 

menu "Item 1": 


.makemenu 5,5,1,4,2,2: 

menu "Item 2": 


// The syntax for .makemenu follows: 

menu "Item 3": 


// .makemenu x, y, start string, # of items, spacing, first item 

menu "Item 4": 

>! 


>! 


Figure 5 ; Parameters for the <clear> Command 


Syntax: <clear #> 

J_ 

0-9 clear numeric array with subscript #. Thus, <clear 2> clears variables A(2) through Z(2). 

50 clear all numeric variables. 

100-190 clear ten strings starting at the value you enter minus 100. Thus, <clear 120> clears strings $20-$29. 
200 clear all string variables. 

255 clear all numeric and string variables. 


<findpo>: Replaced by the dot command “.find- 
po”. Change <findpo> to <.findpo>. 


ues you can use to clear portions of either numeric 
or string variables. 


<menu>: Replaced by a new set of dot commands 
that create menus. Follow the syntax of the exam¬ 
ple in Figure 4. 

<call>: The <call> and <jsr> commands perform 
the same functions in UltraMacros 3. Ultra 4 re¬ 
defines <call> so it calls a macro as a subroutine 
from another task file. See the sidebar entitled 
“Shortening Your Macros” for more information 
about Ultra 4’s <call> command. 

Replace all your UltraMacros 3 references to 
<call> with <jsr>. For example, ccall $300> 
becomes <jsr $300>. 

<clear>: In UltraMacros 3, this command sets all 
numeric variables to zero and all string variables to 
"" (no definition). In Ultra 4, <clear> takes a value 
parameter that lets you clear a designated portion 
of the variables. The chart in Figure 5 lists the val- 


Change all UltraMacros 3 references from <clear> 
to <clear 255> in Ultra 4. 

<find>: Ultra 4 includes significant changes to the 
<find> command; I will describe those changes in 
a later article in this series. 

For now, note that <find> no longer zooms out first 
in the word processor but can find Return “blots” 
without zooming. 

Change all UltraMacros 3 references to <find> as 
follows: 

When UltraMacros 3 Ultra 4 

At a menu: <find> <z=200 : find> 

In the WP: <find> c.zoomin : find> 

(The <.zoomin> Dot Command does the reverse of 
<zoom>. <.zoomin> zooms in to display the print- 
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Shortening Your Macros 


Ultra 4 offers a smaller macro table (3,984 bytes) 
than UltraMacros 3.1 (4,001 bytes). Ultra 4 also 
uses more macro space for begin/rpt loops and if- 
then-else commands than earlier versions of Ultra- 
Macros. If your macros use close to the maximum 
number of bytes allowed in UltraMacros 3.1, you 
may have to shorten them for Ultra 4. 

The quickest way to shorten your macro table is to 
remove the macros you do not use and re-compile. 

If you cannot discard any macros, you can put 
some macros in a separate task file and use the 
Ultra 4 <call> command to call those macros. Use 
the syntax 

<call MACRO in "taskfile"> 

where you replace “MACRO” with the keystrokes 
that call the macro and “taskfile” with the name of 
the task file. Put the name of the task file in quota¬ 
tion marks. For example, 

t:<all: call ea-t in "ULTRA.2“>! 

Ultra 4 returns control to the original taskfile and 
macro after running the macro. This is equivalent 
to calling a macro subroutine, except that you can 
store the macro outside the current macro table. 

The new <call> command takes between 10-24 
bytes (depending on the length of the taskfile 
name), so use the command to call larger macros 
(those with 30 or more tokens or text characters) to 
save bytes in the macro table. 

Once you move one or more macros to another task 
file, recompile your original macro set. Repeat 
these procedures with more macros if the macro set 
is still too large for the compiler. 

Thus, the new <call> command lets you divide 
your macros into two or more task files. That lets 
you create large and complex macros which Ultra 4 
can run as though they were all in memory simulta¬ 
neously. 

er options in word processor documents, formulas 
in the spreadsheet module, and single record layout 
in the data base module. I will describe <.zoomin> 
in a later article in this series.) 


<uc> and <lc>: These two commands no longer 
change the cursor to an overstrike. That means you 
no longer have to preserve the insert or overstrike 
cursor when using <uc> and <lc>. However, you 
do not have to change your macros; older macros 
that use these two commands will work properly in 
Ultra 4. 

<onerr>: In UltraMacros 3, conerr stop> stopped 
the current macro and returned control to the call¬ 
ing macro. In Ultra 4, the conerr stop> option stops 
all macros that are running. To stop a single macro, 
replace conerr stop> with conerr endmacrox 

Ultra 4 also offers conerr exit> which exits a 
begin/rpt loop when it encounters an error. 

coa-ctrl-x>: Ultra 4 does not support coa-ctrl-x> 
as an equivalent for the cclear> command. Instead, 
it uses the cdebug> command that I will describe 
in a future article. 

Replace all coa-ctrl-x> commands with cclear 
255>. 


Managing Variables 

Your Ultra 4 macros can include up to ten times as 
many variables as your earlier macros. However, 
Ultra 4 handles numeric and string variables differ¬ 
ently than earlier versions of UltraMacros. Con¬ 
verting your variables will be one of the more chal¬ 
lenging tasks you face when transforming your 
macros to run under Ultra 4. 


String Variables : Ultra 4 supports up to 100 string 
variables ($0-$99). You can access string variables 
just as you access variables $0 through $9. For 
example: 


x:<all: 


$1 = "This 
$10= "This 
$23= "This 
$99= "This 


is string #1": 
is string #10": 
is string #23": 
is string #99": 


print $99>! 


Numeric Variables: Ultra 4 supports arrays of 
numeric variables such as A(0), A(9), and K(5), 
each of which can store a different number. Ultra 4 
will treat your current references to variables A to 
Z as references to variables A(0) to Z(0). 

Since Ultra 4 does not use sets of variables, the 
program no longer supports the <getvar> and <put- 
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UltraMacros 3.1 

x:<all: 
getvar 2: 

{ use set 2 } 

$1 = "String #1": 

$2 = "String #2": 

X = 5: 
putvar 2: 

>! 

{ store set 2 again } 

Ultra 4 

x:<all: 

$21 = "String #1": 

// store in $21 

$22 = "String #2": 
X(2) = 5: 

>! 

// store in X(2) 


var> commands; you will have to modify all 
macros that use these commands. This involves 
following the logic of the macro to determine what 
to use for each variable name. 

Here is a suggestion to help with that conversion: 
Use the old value of <getvar> as a subscript for 
numeric variables and as the tens value of string 
variables. See the example in Figure 6. 

Conclusion 

This article describes how to convert your Ultra- 
Macros 3 macros to run under Ultra 4. The remain¬ 
ing articles in this series will describe how to use 
the new features of Ultra 4 to create exciting new 
macros and improve your existing macros. 

[Mark Munz, the author of The UltraMacros 
Primer, Companion Plus, Tune Out TextTools, 
MacroEase, Late Nite Patches, and other Apple- 
Works enhancements, is a programmer with Beagle 
Bros.] 
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Need answers to your 
AppleWorks questions? 

Call NAUG’s Members Helping Mem¬ 
bers volunteers listed in the Apple- 
Works Forum for the help you need. 


News and Special Offers for 
NAUG Members 


NAUG 

As the nation’s largest Apple II user group, NAUG 
continues to encourage member-to-member sup¬ 
port services. 

Judging from our mail, the NAUG membership 
includes a significant number of sexagenaria, sep- 
tuagenaria, and octogenaria. 

At the request of these members, NAUG recently 
launched a “Seniors Helping Seniors” program. All 
NAUG members interested in sharing the cama¬ 
raderie of our creative, active, and interesting 
senior members qualify for this program. We wel¬ 
come volunteers of any age; please send your 
name, address, daytime and evening telephone 
numbers, and whether you are a beginner, interme¬ 
diate, or advanced AppleWorks user to “Seniors 
Helping Seniors”, NAUG, Box 87453, Canton, 
Michigan 48187. We will publish the list of volun¬ 
teers in a future issue of the AppleWorks Forum. 

Apple Expo East 

NAUG members attending Apple Expo East 
should bring a copy of the AppleWorks Forum and 
ask for their $5 NAUG discount on the $20 cost of 
admission. 

Apple Expo East features presentations by Roger 
Wagner, Phil Shapiro, Marty Knight, and other 
well-known members of the Apple II community. 
More than 60 companies have booths at the show 
and many will offer special Expo prices on their 
products. The show is October 2 - 4 at the Park 
Plaza Hotel in Boston. 

[Event Specialists, 17 Lilac Road, Sharon, 
Massachusetts 02067; (800) 955-6630; In Mass.: 
(617) 784-4531.] 

Hurricane Andrew... 

Our heartfelt concern for our NAUG colleagues 
who suffered so greatly in Hurricane Andrew. 
Please let us know how we can help you recover 
from this disaster. 
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DRIVE HARD! 


DRIVE SAFE... 



Inside and out, we’ve got a drive for you. From 
our reliable 143K 5.25" floppy drive to 
our super-fast 100MB Vulcan Gold 
Drive, Applied Engineering’s 
disk drives are driven to 
be the best. 


M 3.5" D 

400K/800S/1.44MB Floppy Drive 

• write 400K and 

; ^flHH^tisks on lie, lie, IIcPlus, 
, llQi* Mae and PC Transporter 

BPersion gives you 1.44 
H^bytes on Macintosh and on IIgs 
mm m Apple’s FDHD Controller Card 

Hr Fully Apple compatible 

Hr* 2-way LED indicator, green for read, 
™ red for write 

• Auto eject 

• Daisy chain port—works both ways, 
connect a drive to it, or connect it to 
another drive 


ulcan Gold 

40 to 100MB Hard Drive 

Designed specifically for the Apple II 
series 

Preformatted—plug it in and you’re 
off! 

Vulcan GS preformatted with System 

6.0 

Recognizes ALL Apple software 
including GS/OS, ProDOS, DOS 3-3, 
Apple Pascal, CP/M and MS-DOS for 
the PC Transporter 

Can be split in up to 16 different 
partitions 

Easily controlled through Control 
Panel Device 

70 watt power supply (nearly twice the 
capacity of competing systems) 

Super-fast, state-of-the-art, IDE 
caching drive 

Tested and proven for years with all 
existing peripherals 


5.25" Drive 

143K Floppy Drive 

• 143K Formatted, 35 Tracks, 16 
Sectors 

• Fully compatible with the lie 
Emulation Card for the Macintosh LC 

• Fully compatible with all Apple II 
models 

• Proven Reliability 

• Super Quiet 

• Available Now! 

• Full One-Year Warranty 

5.25" Drive.$210 


Order today! To order or for more 
information, see your dealer or call 
(214) 241-6060 today, 8:30 am to 6:30 
pm (CST), M-F. Or send check or 
money order to Applied Engineering. 
MasterCard, VISA and C.O.D. welcome. 
Texas residents add applicable sales tax. 


Applied Engineering® 

The Apple enhancement experts since 1979. 


• Stack and footprint compatible with 


Apple Drive 

• Conserver compatible 

• Full One-Year Warranty 

JE 3.5" Drive (800K).$279 

/EHD 3.5" IIgs High Density Drive 
(1.44MB).$339 


• Support for years to come 

• Full One-Year Warranty 

40MB Vulcan Gold Drive.$899 

100MB Vulcan Gold Drive.$1,795 


A Division of R Research Corporation 


(214) 241-6060 
FAX: (214) 484-1365 


3210 Beltline 
Dallas, TX 75234 


Made 


USA 


©1992. AE Research, Inc. All rights reserved. Brand and product 
names are registered trademarks of their respective holders. All 
specifications, terms and services are subject to change without 
notice or recourse. Prices subject to change without notice. 










Educational Applications 


Play “AppleWorks Jigsaw Puzzle” 

by Phil Shapiro 


This is the first of two articles that describe how to use AppleWorks to create reading com¬ 
prehension exercises. This month, Mr. Shapiro describes how to create “jigsaw puzzles”. 
Next month, Mr. Shapiro describes his game of AppleWorks Anagrams. 


S everal years ago, I was smitten by an education¬ 
al language arts game named Hide ‘n’ 

Sequence, published by Sunburst. The game starts 
by presenting the opening sentence from a reading 
passage. You then reconstruct the entire passage by 
successively choosing from three possible sentences. 
You can take as much time as you need to decide 
which of the three sentences logically follows from 
the preceding material. This type of language exer¬ 
cise helps students develop an appreciation for the 
subtle connections that link sentences into meaning¬ 
ful writing. 

Of course, you can create your own variation of 
Hide V Sequence with AppleWorks. This 
game has all the fun and excitement of a 
physical jigsaw puzzle except, instead of fit¬ 
ting together pieces of wood and cardboard, 
students fit together sentences and paragraphs 
into a unified, meaningful whole. And your 
students will learn how to use AppleWorks as 
they play. 

Pairs or triads of students can play, but the 
most exciting approach has the entire class 
work together to create and solve one puzzle. You 
will need to customize my suggested procedures to 
allow for differences in class size and computer 
set-ups. 

Students need a mature appreciation of the sub¬ 
tleties of language to enjoy and benefit from this 
game. You will find it difficult to use the game 
with children below sixth grade. 

How It Works 

Here is how the game works. First you find or cre¬ 
ate one or more fiction or non-fiction passages 


whose sentences progress logically from the begin¬ 
ning to the end of the passage. I suggest that you 
try this activity first with non-fiction passages; 
those passages often have an inherently tight logi¬ 
cal structure. 

Mixing up the AppleWorks jigsaw puzzle is almost 
as much fun as trying to solve it. To add drama to 
this exercise, you might designate two or three stu¬ 
dents as a “detective team”. Send the “detectives” 
out of the room while the class reorganizes the pas¬ 
sage; the secrecy adds suspense to the exercise. 

First you load a reading passage into AppleWorks. 
Then have one or more students in your class use 

AppleWorks’ Move Com¬ 
mand to move one sentence 
or an entire paragraph from 
the middle to the end of the 
passage. However, do not 
move text from the opening 
sentences of the passage; the 
“detectives” need a “set¬ 
ting” to help them under¬ 
stand the moved sentence or 
paragraph. Try to move text that contains subtle but 
logical links to the body of the prose. 

Then call the detectives back into the classroom, 
print the passage, and give them a printed copy to 
study. Tell the detectives to read the moved sen¬ 
tence or paragraph before trying to figure out 
where to put it. 

Let the detectives confer among themselves look¬ 
ing for subtle clues. When they think they solved 
the puzzle, they can go to AppleWorks and use the 
Apple-M command to move the sentence or para¬ 
graph back to its proper position. 


a This exercise 
helps students 
appreciate the 
subtle connections 
in meaningful 
writing” 
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Educational Applications ... 

You can add to the fun by turning off the large 
screen monitor while the students reorganize the 
paragraph. Then let the detectives use TimeOut 
FileMaster or the freeware File Compare utility to 
compare the reconstructed AppleWorks file with 
the original. The students can run the file compari¬ 
son and turn on the monitor with a flourish to show 
the results. 

Help Getting Started 

To help you get started, I assembled several pas¬ 
sages that NAUG will distribute on its new 
“Shapiro’s Jigsaw Puzzle Disk”. The disk also 
includes a bootable copy of File Compare and 
some instructions to help you use the program. 
Several of these passages also appear on the new 
Big Text Machine Sample Files disk. [Ed: Mr. 
Shapiro’s Big Text Machine lets you display Apple- 
Works and other text fdes in attractive large fonts 
on your Apple II screen.] 

Not all teachers will have the time or inclination to 
create their own reading passages for “AppleWorks 
Jigsaw Puzzle”. But if several of the more energet¬ 
ic NAUG teachers each contribute two or three 
original reading passages, we should be able to 
assemble several more NAUG disks for use with 
the game. 

It may even be possible to coax high school stu¬ 
dents to write reading passages for use by younger 
students in this activity. Not only would such writ¬ 
ings be useful to other teachers and students, but 
the authors of these passages would have a ready 
“writing sample” for use at job interviews. Not to 
mention extra “brownie points” on their resumes. 

[Phil Shapiro is the founder of Balloons Software, 
5201 Chevy Case Parkway, NW, Washington, DC 
20015. Balloons Software developed Big Text 
Machine, Number Squares, and other Apple II edu¬ 
cational software. You can reach Mr. Shapiro on 
GEnie as “p.shapirol ” or on America Online as 
“pshapiro”.] 

[“Shapiro’s Jigsaw Puzzle Disk” costs $4 (5.25- 
inch disk) or $6 (3.5-inch disk) plus $2 s/h per 
order from the NAUG Public Domain Library. ] 


AppleWorks News 

News and Special Offers for 
NAUG Members 


Bemak Enterprises 

Bemak Enterprises offers NAUG members special 
prices on the company’s AppleWorks 3.0 Golf, 
Handicap Golf, and Bowling Scores templates. 

Bemak’s Golf Scores Disk contains word processor 
and spreadsheet templates designed to help non¬ 
handicap golfers keep track of their scores and 
statistics. Other templates print a score card you can 
use on the course and different award certificates. 

Golf Scores tracks up to seven 9-hole rounds of 
golf on 128K systems and twenty-eight 9-hole 
rounds on 256K computers. 

Bemak’s Handicap Golf Disk makes it easy to cal¬ 
culate your USGA handicap by tracking your per¬ 
formance on your fifty most recent 18-hole rounds 
of golf. The Handicap Golf template can compute 
your course-specific handicap if you provide the 
USGA Course Rating and the USGA Slope Rating 
for the course. 

Other templates on the disk track many of the same 
data and produce the same score card and certifi¬ 
cates as the Golf Scores Disk. 

The company’s Bowling Scores Disk tracks indi¬ 
vidual and team bowling scores and statistics. Tem¬ 
plates track the number of strikes and spares rolled 
per game and compute the averages and handicaps 
for individual and team bowling. The disk includes 
an AppleWorks data base file that can help a league 
secretary record information on all bowlers. 

Word processor templates on the disk print score 
sheets you can use at the bowling alley and award 
certificates you can distribute to the best performers. 

Each Bemak disk lists for $19.95. Until January 1, 
1993 NAUG members can buy each disk for 
$12.95 plus $2.50 s/h per order. Specify 3.5-inch or 
5.25-inch disks and include your NAUG member¬ 
ship number with your order. 

[Bemak Enterprises, 728 Royal Street, Alton, Illi¬ 
nois 62002; (618) 462-7419.] 
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My Favorite Template 


A Gradebook Template - Part One 

by Stan Hecker 


This is the first of two articles that describe how teachers can use AppleWorks to maintain 
and report student grades. The author assumes that you know the basics of spreadsheet 
operation. NAUG members not familiar with the AppleWorks spreadsheet should first read 
the articles in the booklet entitled “How to Get Started with the Spreadsheet Module", 
which costs $9.25 postpaid from NAUG. 


Figure 1: The Gradebook 


File: Gradebook REVIEW/ADD/CHANGE Escape: Main Menu 

==========A=========B=====C===D===E===F===G===H===I=====J======K=====L=====M=== 
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S how me five teachers and I will 
show you five different record¬ 
keeping systems. Although there are 
probably as many different grade- 
books as there are teachers, this 
month’s gradebook template (see 
Figure 1 ) includes some ideas that 
you can use in your electronic 
recordkeeping system. 

A working copy of the template 
appears on this month’s issue of 

NAUG on Disk. 

This is the first of two articles about 
classroom gradebooks. This month 
you will learn how to create the 
template. Next month you will use 
this template to produce individual 
reports that use the close integration 
of the three AppleWorks modules. 

This template can accommodate up to six students 
and five measurements, which is too small for 
practical use. The section entitled “Expanding this 
Template” near the end of the article describes how 
to enlarge the template to accommodate more stu¬ 
dents and grades. 

The template refers specifically to “tests” and 
“homework”, although you can use the template to 
store grades from any project or assignment. 

Much of the complexity of the formulas in this 
gradebook comes from the decision to drop the 
lowest test score from each students’ average. 
Beginning spreadsheet users can enter the formula 
without understanding its logic. Advanced spread¬ 


sheet developers might enjoy trying to create the 
formula in cell Jll before they get to step #14 in 
this article. Then compare that formula to the sim¬ 
pler formula in cell Kll. 

The formulas in the template also demonstrate how 
you can display blank cells instead of error mes¬ 
sages. That trick uses AppleWorks 3.0’s ability to 
manipulate text in the spreadsheet. Earlier versions 
of AppleWorks did not offer this capability, so the 
template requires AppleWorks 3.0. 

Building the Template 

1. Start by launching AppleWorks and creating a 
new spreadsheet called “Gradebook”. Save the 
template to disk often as you work. 
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Figure 2: Format for Cells 


Cells 

Type 

Layout 

The block 

A8 through B9 

Label 

Centered 

The block 

All through B16 

Label 

Left Justified 

J7 and K7 

Value 

Fixed, 2 decimal places 

LI through L5 

Value 

Fixed, 0 decimal places 

Ml through M5 

Label 

Centered 

The block 

Jll through Lll 

Value 

Fixed, 1 decimal place 


Figure 3: Formula for Cell J11 


@IF(0OR(A11=*",D11=""),C11,(@SUM(C11...Ell)-@MIN(C11...Ell)/(@C0UNT(C11...Ell)-1))) 


O 


<D 


© 


© 


2. Widen column A to 12 characters to accommo¬ 
date long last names. 

3. Narrow column B to 8 characters. 

4. Narrow columns C through I to 4 characters. 

5. Narrow columns J and K to 7 characters. 

6. Narrow columns L and M to 6 characters. 

7. Issue an Apple-V command and set the stan¬ 
dard value format to “Fixed, Zero Decimal 
Places” and set the standard label format to 
“Right Justified”. Also set the calculation fre¬ 
quency to “Manual”. 

8. Use the Apple-L command to set the format for 
the cells listed in Figure 2. 

9. Add the labels in rows 2 through 10 and 17 
through 18 in Figure 1. (Remember to enter a 
quotation mark to start a label that begins with a 
hyphen, an equals sign, or a blank space.) 

10. Enter the formula 1-J7 in cell K7. The number 
“1” will appear in the cell. This formula auto¬ 
matically calculates the weight assigned to stu¬ 
dent homework after you enter the weight 
assigned to test scores. 

11. Enter the value of zero in cell LI. 

12. Enter the value 49.5 in cell L2. A “50” will 
appear in your template. Similarly, enter 69.5 in 


cell L3, 79.5 in L4, and 89.5 in 
L5. These values insure that stu¬ 
dents who get grades up to 1/2- 
point below the cut-offs receive 
the next higher grade. 

13. Enter the letter grades F, D, C, 
B, and A in cells Ml through 
M5 respectively. 

The Formulas 

Now you will enter the formulas in 
row 11. The pairs of quotation 
marks (“") in these formulas signify 
a “nothingness”, technically called 
a “null set”. (To a computer, a 
blank space is a character and a 
zero is a value. Thus, blanks and 
zeros are “something”. Putting ■" 
in an equation signifies that you want to test for 
“emptiness”. For example, the formula 
@if(ai=0, "",B1) leaves the current cell empty if cell 
A1 contains a zero or non-numeric entry.) 

First you will enter the formula in Figure 3 into 
cell J11. (Do not enter the formula until you read 
the step-by-step instructions below. The formula is 
too long to fit on the data entry line.) 

This formula says: 

Segment Q : “If the last name cell is blank, then 
there are no grades in this row; leave cell Jll 
blank. 

“Or, if there is no second test score in cell Dll, dis¬ 
play the student’s first test score as the average 
score.” 

Segment © : If both All and Dll contain entries, 
this row contains data for a student who took at 
least two tests. Now you need to throw out the low¬ 
est test score. Segment B of the formula says: 

“Sum the test scores in cells Cll through Ell.” 

Segment © : “Then subtract the single lowest 
score in that range from the sum.” 

Segment © : “Now divide the result by the total 
number of test scores in the same range, less one, 
to account for the single test score you threw out. 
Display this average.” 
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As indicated earlier, the formula will not fit on the 
data entry line. The following steps demonstrate a 
work-around that lets you enter long formulas. The 
technique is to enter a portion of the formula, then 
display the formula on the Edit Line and enter the 
remainder of the formula. Follow these steps: 

14. Enter the following into cell J11. Then press the 
Return Key. 

©IF(@OR(All=““,D11=""),Cll,(©SUM(Cll.Ell) 
-©MIN(C11.E11)/1)) 

15. Issue an Apple-U command. AppleWorks will 
display the following formula on the Edit Line 
at the bottom of the screen: 

@IF(@OR(All="“ / Dll="“),Cll,(@SUM(C11...Ell) 
-@MIN(C11. . .E1D/1)) 

Note that AppleWorks substituted three dots for 
the single periods you typed between “Cll” and 
“Ell” at two places in the formula. Start by 
using the Arrow Keys and the Delete Key to 
delete the extra periods so you can fit the final 
formula on the Edit Line. 

16. Now put the cursor at the end of the formula 
and press the Delete Key three times to delete 
the two right parentheses and the digit “1” from 
the end of the expression. The formula will look 
like this: 

@IF(@OR(All= B " / Dll=“"),C11,(©SUM(Cll.Ell) 

-©MIN(Cll.Ell)/ 

with the cursor blinking at the end of the 
formula. 

17. Finish the expression by typing the following 
after the 

(@C0UNT(C11.E11)-1))) 

Then press the Return Key. 

That completes the formula in Figure 3, which, as 
indicated earlier, is too large to fit on the screen. 

18. Enter the following formula in cell Kll: 

GIF(@OR(All="“,Fll=""),"",©AVG(Fll.Ill)) 

This formula says “If the last name cell is blank 
or if the first homework field is blank, then 
there is either no student here or the student did 
not hand in any homework. In either case, dis¬ 
play a blank. Otherwise, display the average of 
the homework assignments.” 


Unlike cell J11, which required a lengthy for¬ 
mula, your decision to retain all of the student’s 
homework scores lets you use the simpler 
@AVG function in cell Kll. 

19. Use the Apple-C command to copy the formu¬ 
las in cells Jll and Kll into rows 12 through 
16. Issue an Apple-R to command “relative” for 
all cell references. 

20. Enter the following formula in cell Lll: 

©IF (Alls’" 1 , "" ,@IF (@OR( J11="" / K11=““), 

Jll+Kll,(J11*J7)+(K11*K7))) 

This formula computes the weighted average. 
The formula says, “If the last name cell is 
empty, then leave this cell blank. Otherwise, 
check both the ‘test average’ and ‘homework 
average’ cells. If either the ‘test average’ or 
‘homework average’ cell is blank, display the 
sum of both fields here. If both cells contain 
values, multiply each by the weighting factors 
near the top of this column, add them together, 
and display the result.” 

21. Enter this formula in cell Mil: 

©IF(All="","- \©LOOKUP(Lll, LI...L5)) 

This formula assigns a letter grade for each stu¬ 
dent. It says: “If the last name cell is blank, dis¬ 
play a dash as a placeholder. Otherwise, look up 
the student’s grade in the table in cells LI 
through M5.” 

22. Copy cells Lll and Mil into rows 12 through 
16. Respond to the “Relative or No change?” 
question with “Relative” except when Apple- 
Works highlights cells J7, K7, LI, and L5. In 
those four cases, press “N” to specify “No 
change”. 

23. Now you will enter the formula that calculates 
the class average for each test and assignment. 

Type this formula into cell Cl8: 

©IF(©COUNT(C10...C17)=0,©AVG(C10...C17)) 

This formula counts the number of entries in 
cells CIO through C17 and displays a blank 
instead of an error message if it finds no student 
grades in those cells. If it finds one or more stu¬ 
dent grades, the formula displays the average of 
those grades. 
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24. Copy the formula from cell C18 into cells D18 
through LI8. Issue an Apple-R to specify “Rel¬ 
ative” in response to the “Relative or No 
change?” question. 

Protect Your Work 

25. Put the cursor in cell Al, issue an Apple-L, 
select “Block”, and set protection for the whole 
spreadsheet to allow “Nothing”. 

26. Use the Apple-L command to set the protection 
for cell J7 and cells LI through L5 to “Values 
only”. 

27. Set protection for the block of cells All 
through B16 to “Labels only”. 

28. Set protection for the block of cells Cll 
through 116 to “Values only”. 

29. Use the Apple-V command to turn protection 
on and to change the calculation frequency to 
“Automatic”. 

30. For extra security, lock the template, using 
BASIC, Copy II+, FileMaster, or some other 
utility program. (For step-by-step directions, 
see the article entitled “How to Lock Your Tem¬ 
plates” in the May 1991 issue of the Apple- 
Works Forum.) 

31. Save the template to disk; you will use it next 
month to explore the integration of the Apple- 
Works modules. 

Using the Template 

Follow these steps to use the template: 

1. Load the template onto the AppleWorks desk¬ 
top. 

2. Issue an Apple-N command and name the file 
“Class 1”. 

3. Set the weighting so that your tests determine 
50% of the students’ final grade by entering 
“.5” into cell J7. 

4. Change the standard for passing to 65% by 
entering “64.5” into cell L2. 

5. Enter student names and their scores on your 
tests and assignments. 


Remember that you can use the Apple-A command 
to arrange the student records alphabetically by 
name, by overall class standing, or by any test or 
assignment. Just remember to save your work 
before re-arranging the data; AppleWorks does not 
offer an “unarrange” command. 

Expanding the Template 

Unfortunately, few of us get to teach classes with 
only six students. Follow these steps to add stu¬ 
dents to the template: 

1. Issue an Apple-V command and set Protection 
to “No”. 

2. Put the cursor anywhere in row 17 and issue an 
Apple-I command. Indicate that you want to 
insert rows and specify the number of rows to 
insert. 

3. Put the cursor in cell A16 and use the Apple-C 
command to copy cells A16 through K16 into 
the new rows. Issue an Apple-R in response to 
the “Relative or No change?” question. 

4. Use Apple-C to copy the formula from cell L16 
into the new rows. Respond “Relative” when 
AppleWorks highlights “A 16”, “J16”, and 
“K16”. Respond “No change” when Apple- 
Works highlights “J7” and “K7”. 

5. Use Apple-C to copy the formula from cell 
M16 into the new rows. Respond “Relative” 
when AppleWorks highlights “A16” and “LI6”. 
Respond “No change” when AppleWorks high¬ 
lights “LI” and “L5”. 

6. Use Apple-V to re-establish cell protection. 

Adding Tests and Homework Assignments 

Adding tests and homework assignments involves 
inserting columns into the template. Add the 
columns in front of the last test and assignment. 
That eliminates the need to edit the formulas in 
columns K and L of the basic template. 

Follow these steps to add more assignments: 

1. Put the cursor in cell II, issue an Apple-I, and 
insert as many extra columns as you need in 
your gradebook. 
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2. Move the cursor back to cell HI. Use Apple-C 
and Apple-9 to copy the entire column H into 
the new columns. Press Apple-R to command 
“Relative” in response to the “Relative or No 
change?” question. 

3. Correct the copied labels in row 8 for the cells. 
Also correct the assignment numbers at the top 
of the columns. 

Follow these steps to add space for more tests: 

1. Put the cursor in cell El, issue an Apple-I, and 
insert as many extra columns as you need in 
your gradebook. 

2. Move the cursor back to cell Dl. Use Apple-C 
and Apple-9 to copy the entire column D into 
the new columns. Press Apple-R to command 
“Relative” in response to the “Relative or No 
change?” question. 

3. Move to row 8 and clean up the copied labels 
for the cells. Similarly, change the test numbers 
at the top of the columns. 

Save the revised template to disk under its new 
name. Do not discard the original version; you will 
use this template next month to explore the integra¬ 
tion of the AppleWorks modules. 

[Stan Hecker is on the administrative staff at 
Michigan State University, East Lansing, Michi¬ 
gan, and is a partner in H&H Consulting, a Michi¬ 
gan concern specializing in school district finan¬ 
cial and population analyses.] 

[The author thanks to Dr. Avram Malkin, an Assis¬ 
tant Professor at the DeVry Technical Institute 
(Woodbridge, NJ) for submitting a gradebook tem¬ 
plate that inspired these articles. His incisive sug¬ 
gestions about integrating the modules served as 
the foundation for next month’s discussion.] 

[A working copy of this template appears on this 
month’s issue of NAUG on Disk, which costs $10 
from NAUG. The template requires AppleWorks 
3.0; NAUG on Disk requires a 3.5-inch disk 
drive.] 


News and Special Offers for 
NAUG Members 


JEM Software 

JEM Software announced special NAUG prices on 
its line of AppleWorks 3.0 data base enhancements. 
Until December 1, NAUG members who order 
TotalControl 2.1 for the regular $60 price will 
receive a copy of DoubleData 2.0 (regularly $40) 
free. NAUG members who order TotalControl can 
also buy the company’s DB Pix enhancement for 
only $12 (regularly $25). 

TotalControl 2.1 adds many features to the Apple- 
Works data base module, including relational capa¬ 
bilities and data entry rules. (A comprehensive 
review of TotalControl appears in the May 1992 
issue of the AppleWorks Forum.) 

DoubleData 2.0 seamlessly expands the Apple- 
Works 3.0 data base to include up to 60 categories 
per record. 

DB Pix 1.0 lets you display Single HiRes, Double 
HiRes, and PrintShop graphics in your data base 
layouts. 

TotalControl, DoubleData, and DB Pix come on 
3.5-inch disks unless you request 5.25-inch copies 
of the programs. Include your NAUG membership 
number with your order. Add $3 s/h ($5 overseas); 
Colorado residents must add sales tax. 

[JEM Software, 7578 Lamar Court, Arvada, Col¬ 
orado 80003; (303) 422-4856for 24-hour 
Visa/MasterCard order line or fax.] 


Classifieds 

FOR SALE: LIGHTNING SCAN 400. (used only once) with READ-IT (OCR) software * 
For Macintosh. $200. Call Jim (202) 347-1171,9-5 pm M-F. 

MAMMOTH SPANISH CUSTOM SPELLING DICTIONARY for AppleWorks 2.x and 
3.0. A must for teachers and invaluable for all. For free information, send letter size 
SASE to: Clipvision, 1440-A-Engracia Ave, Torrance, CA 90501; (310) 328-2887. 

BEST BUY GENEALOGY PROGRAM. Let FAMILY TREE automatically link your fami¬ 
ly’s history into an easy to operate data base. ProDOS based FAMILY TREE is fast, fun, 
and very user friendly. FAMILY TREE will print a wide variety of outputs to your printer or 
to AppleWorks files. It even shows family relationships! Imports data from your Apple- 
Works or LDS PAF data files. For enhanced lie, lie, or llgs. YOU GET IT ALL FOR 
ONLY $49.95 +$2.50 S&H (CA add tax). SATISFACTION GUARANTEED! SASE for 
more information or send check or money order to the author: Robert M. Merrill, 6180 
Via Real N-25, Carpinteria, CA 93013-2863. 
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My Favorite Macro 

How to Use UltraMacros 
Subroutines 

by Keith Johnson 


U nderstanding how a macro operates is a good 
idea, even if you do not create your own 
macros. You can use these skills to improve the 
macros you use in your daily operations. 

Macro programmers often use subroutines; sepa¬ 
rate macros used by other macros to accomplish a 
particular task. You can identify the subroutine 
macro by the <asr> (“AppleWorks Subroutine”) 
designator that comes right after the keystroke that 
names the macro. A subroutine often saves valu¬ 
able space in your macro set. 

Waiting for a Keypress 

For example, imagine that you want a macro to 
pause while displaying a message and wait for the 
user to press a key. You may want to store the 
value of that key for further use, then clear any 
message on the screen. You can accomplish that 
task by including the following lines in your 
macros: 

k = key : { Get a keypress. } 

msg : { Clear the current message, if any. > 

$1 = chr$ k : { Define a string variable that } 

{ contains the keypress. } 

This does the job. But suppose that several macros 
need to perform this task. If you insert these com¬ 
mands into each macro, you will use up valuable 
space. Instead, you should define the following 
subroutine macro: 

K:<asr>< { Define subroutine. } 

k ■ key : msg "" : $1 = chr$ k>! 

Then call this subroutine whenever you need to 
capture a keystroke. For example: 

D:<all> 

<msg 1 today is 1 +date+ 1 (key) ' : { Display date. } 
sa-K>! { Call sa-K. } 


This macro displays the date on the message line 
and then runs the <sa-K> subroutine, which waits 
for a keypress and clears the message. Note that 
this macro does not use the value stored in $1 by 
the subroutine. 


Layers 

UltraMacros’ ability to call a subroutine from with¬ 
in a subroutine gives you even more flexibility. For 
example, imagine that you want some of your 
macros to clear the message without waiting for a 
keypress. You want other macros to wait for the 
keypress. The best approach is to separate the sa-K 
subroutine into two subroutines, one of which calls 


the other, as follows: 

M:<asrxmsg "">! { Clear the message. } 

K:<asrxk = key : { Get a keypress. > 

sa-M : { Call sa-M to clear message.) 

$1 = chr$ k>! { Get string variable. ) 

You could even create a third subroutine that does 
not define $ 1: 

Nxasrxk = key : { Get a keypress. ) 

sa-M>! { Call sa-M to clear message.) 


Of course these examples divide the tasks into 
overly-small chunks, but I want to keep things sim¬ 
ple for explanatory purposes. 


Keep Things in Order 

Make certain that the calling macro calls the cor¬ 
rect subroutine. This can be a problem if you use 
the same defining token, or name, for your subrou¬ 
tine that you used for a “regulaf ’ macro. For exam¬ 
ple, consider this set of three macros: 

K:<asrxk = key : { Get a keypress. } 

msg “">! { Clear the message. } 
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K:<awp><$5 = "Date is " + date : 
msg $5>! { Display the date message. } 

M:<awpxmsg "Press a key" : { Display a message. } 

sa-K>! { Call sa-K. } 

If you press <sa-M> in the word processor, the 
<sa-M> macro displays the message “Press a key” 
and then calls <sa-K>. UltraMacros goes to the top 
of your macro set and starts looking for a macro 
named <sa-K> that it can run from the word pro¬ 
cessor. In this case, it encounters the <sa-K> key- 
press/message-clear subroutine and it runs that 
macro, which is what you want. 

But suppose you typed the same three macros in 
the following order: 

K:<awp><$5 = "Date is " + date : 
msg $5>! { Display the date message. } 


K:<asrxk = key : msg "">! { Get a keypress. } 

{ Clear the message. } 

Mxawpxmsg "Press a key" : { Display a message. } 

sa-K>! { Call sa-K. } 


Pressing <sa-M> still displays the “Press a key” 
message and sends UltraMacros looking for a 
<sa-K> macro. But now it encounters the date 
macro first, so it replaces the previous message 
with a new one proclaiming the current date. That 
is not what you intended. 

The best way to insure that subroutines run properly 
is to put them at the beginning of your macro set. 
Since you cannot run subroutines by pressing keys, 
you cannot run these macros accidentally. You can 
even assign the subroutines the same name that you 
use for the macro that calls them. 

Using Ultra 4 

Ultra 4 gives you two ways to handle subroutines. 
First, the new version of UltraMacros continues to 
support the <asr> macros described above. Ultra 
4’s expanded <call> command also lets you store 
your subroutines in a separate task file that you can 
call from any macro. [Ed: See the UltraMacros 
Primer article that starts on page 11 for examples 
of how to use Ultra 4’s new <call> command.] 

Second, Ultra 4 supports “labels”, which consist of 
a sequence of actions that you can call from any 
macro. For instance, instead of 

K:<asrxk = key : msg : $1 = chr$ k>! 


you can define the label 

ttclearmessage = k = key : msg : $1 = chr$ k 

and insert “#clearmessage” anywhere in a macro 
set where you previously used <sa-K>. 

However, you must respect the following two limi¬ 
tations in your labels: 

1. All label definitions must fit on a single line, so 
you cannot use labels to define complicated 
procedures. 

2. You must define all your labels at the begin¬ 
ning of your macro set. That is a good practice 
anyway. 

[Keith Johnson is Associate Director of the Fleis- 
chmann Planetarium at the University of Nevada.] 



MOVING? 


Remember to notify NAUG if you change your 
address. Do not rely on the post office to forward your 
mail; you may miss some issues. Send address 
changes to NAUG; Box 87453; Canton, Ml 48187. 


LockOut 2.0 

C 

Hundreds of schools trust 
LockOut to save their teachers 
from hours and hours of 
frustration. 

QJ 

> 

LockOut prevents students from 
changing the Control Panel settings 
on IIGS computers, without disabling 
any NDA, CDA, or CDev that does not 
change settings. Includes Installer utility, 

40 page manual, and a license to use 
it on all fileservers, hard disks, and 
floppies in a single building. 90 day 
unconditional money back guarantee. 

O 

$49.95 from ... 


SuperStuff 
3382 Sandra Drive 

CL 

Kalamazoo, Michigan 

49004 
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Word Processor Tips 


How to Enhance Your Documents 
with MouseText - Part Two 

by Warren Williams and F. David Stephansky 


This is the second of two articles that describe how to add MouseText to your AppleWorks 
word processor documents. The authors assume that you read the article in last month’s 
issue of the AppleWorks Forum. 



L ast month you learned how 
to incorporate MouseText 
in your printed output. The pro¬ 
cedures we described let you 
produce attractive documents 
that include boxes, diamonds, 
and other graphic elements. 

Of course, much of today’s 
writing never appears on a 
printed page. Increasingly, we 
design documents that users 
read on the computer screen. 

For example, program develop¬ 
ers often provide directions in 
word processor files on a disk. 

Teachers give students elec¬ 
tronic copies of their instruc¬ 
tions and comments. And other documents, such as 
NAUG on Disk and TimeOut Central, only exist 
on disk and never appear on a printed page. 

As you saw last month, the techniques you use to 
add MouseText to printed documents actually 
decrease their on-screen readability. This month 
you will learn how to prepare attractive documents 
that display MouseText, underlining, and inverse 
characters on the screen. You can use these tech¬ 
niques to develop attractive screen displays like the 
example in Figure 1. 

Some Background 

Here is some background to help you understand 
the procedures that generate the on-screen Mouse- 
Text. 


Computers store each character in one “byte” of 
memory. Each byte includes eight storage locations 
(called “bits”) that you can think of as switches. 
The computer represents each letter of the alphabet 
by a different combination of on-off settings of 
these “switches”. For example, Figure 2 presents a 
schematic representation of the “switch settings” 
stored in your computer when you type the letter 
“A”. 

You can arrange these switches in 256 different 
combinations of on-off patterns. Thus, each set of 
eight switches can represent 256 different charac¬ 
ters. However, you can only type about 128 differ¬ 
ent printable characters from the keyboard. As a 
result, your computer never needs the left-most 
switch (which represents “128”, the highest num¬ 
ber in the switch sequence), to store a text charac- 
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included on the “Cleme- 
sha’s Apple Works Acces¬ 
sories Disk” available from 
NAUG. MouseText Maker 
makes it easy to display 
MouseText graphics, 
inverse characters, and 
underlined characters in 
Apple Works documents on 
your screen. 


ter. Thus, the industry standard for text characters 
(called the ASCII standard) only uses the lowest 
seven of the eight switches to represent different 
characters. 

Of course, computer manufacturers like to use the 
full capabilities of their systems, so they use this 
eighth (or “high”) bit to perform other functions. 
Apple lie, lie Plus, IIgs, and enhanced Apple He 
computers use this bit to tell the computer whether 
to use the standard character set (high bit turned 
off) or an alternate character set built into these 
computers. The alternate character set includes 
inverse versions of all the lower-case characters 
and a set of graphic “characters” that we call 
MouseText. 

Obviously, then, the way to produce MouseText 
and inverse characters on the screen is to type the 
keyboard equivalent of each character and then 
turn the high bit switch on for each of those charac¬ 
ters. 

Turning the High Bit On 

Unfortunately, there is no “turn-the-high-bit- 
switch-on” key on your keyboard; you must use 
software to change the switch settings. 

Advanced Apple II users can use “disk zapping” 
programs such as those included with ProSel and 
Copy 11+ to turn the high bit on for these charac¬ 
ters. But that is a tedious process that must be done 
with care so you avoid changing any other charac¬ 
ters in the file. 

An easier approach is to type your document and 
then use a macro or TimeOut application to change 
these characters. We use Barclay Clemesha’s 
“MouseText Maker”, a TimeOut application 


Using MouseText Maker 

Using MouseText Maker is a three-step process: 

1. Install the program. 

2. Create AppleWorks documents with embedded 
codes to turn MouseText, inverse, and underline 
on and off. 

3. Run MouseText Maker to convert the charac¬ 
ters. 

The process is easy because (a) you only install 

MouseText Maker once, and (b) MouseText Maker 

uses Boldface Begin/End Commands to turn 

MouseText on and off and Underline Begin/End 

Commands to control underlining. 

Just follow these steps: 

1. Install MouseText Maker by copying the file 
TO.MOUSE from the Clemesha’s AppleWorks 
Accessories Disk onto your TimeOut Applica¬ 
tions Disk or into the subdirectory you use to 
store your TimeOut applications. 

2. Launch AppleWorks. 

3. Prepare a new word processor document named 
“TEST” and set the left and right margins to 0.0 
inches. 

4. Type all the letters of the alphabet in upper case 
with a space between each letter. 

5. Type the following characters at the end of the 
line with a space between each character: “@”, 

4trt4 U15? U\5> “A’’ u ” 

L t J > ' > > — • 

6. Copy the entire line to the clipboard. Then 
leave a blank line and copy the text from the 
clipboard. 
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on that line. Putting the space at the 
beginning of the second line of text 
will align each letter of the alphabet 
with its corresponding MouseText 
character.) 

Now you will enter the Underline 

Begin/End Commands. These com¬ 
mands go on the first blank line under 

the second row of characters. 

9. Move the cursor to the beginning of 
the blank line under the second row 
of characters and issue an Under¬ 
line Begin Command. 

10. Press and hold down the Space Bar 
to move the cursor so it is under the 
first blank space after the underline 
character. Then insert an Underline 
End Command. 

11. Press the Return Key twice, enter a 
Boldface Begin Command, and 
type “the quick brown fox jumped 
over the lazy dogs” in lower case 
characters. Then enter a Boldface 
End Command. Your screen should 
look like the example in Figure 3. 

12. Go to the TimeOut Menu and 
launch MouseText Maker to display 
the screen that appears in Figure 4. 

13. Press the Return Key to convert all 
the characters between the Boldface 
Begin and Boldface End Com¬ 
mands into MouseText. 

14. Return to the TimeOut Menu, 
invoke MouseText Maker a second 
time, select #2 (“Insert Underline 
Symbols”), and press the Return 


7. Issue an Apple-1 to put the cursor at the begin¬ 
ning of the first line of text and issue a Boldface 
Begin Command. Move the cursor to the end of 
the line and issue a Boldface End Command. 

8. Insert a blank space at the beginning of the sec¬ 
ond line of text. (MouseText Maker removes 
the caret ( A ) that marks the Boldface Begin 
Command in line 1 but does not move the text 


Key. Your screen should look like 
the example in Figure 5. 

To learn more about on-screen MouseText and 
underlining, we suggest that you repeat the tutorial 
in last month’s article but issue Boldface 
Begin/End Commands in place of the Special 
Codes Commands described in that article. Then 
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Word Processor Tips ... 


Figure 5: WP Screen with MouseText 


File: TEST 
=====<====< 


REVIEW/ADD/CHANGE 


<====<====<====<====<====<====<====<== 
dkW^!f.ir t Jin , >::4:-L-)sic3 i ♦ $ 1 3 i # 
ABODE FGHI JKLMNOPQRSTPVWXYZe [] \ A _ 


the quick brown fox jumped over the lazy dogs 


Escape: Main Menu 
==<====<====<==== 


Type entry or use (3 commands 


Line 3 Column 2 


launch MouseText Maker and convert your screen 

to the display that appears in Figure 1. 

Tips and Ideas 

Here are some suggestions to help you use Mouse- 

Text Maker: 

1. MouseText Maker converts each upper case 
character to its MouseText equivalent. Figure 3 
in last month’s article shows the MouseText 
equivalent for every character. 

2. Use on-screen underlining sparingly, and only 
in documents that you double space on the 
screen. Since you must put the Underline 
Begin/End Commands on a blank line under¬ 
neath the text you want underlined, you cannot 
use MouseText Maker to underline single 
spaced documents. 

3. MouseText Maker is partially reversible. Insert 
Boldface Begin/End Commands around your 
MouseText and process the document through 
MouseText Maker a second time. The program 
will convert each MouseText graphic back to its 
corresponding upper case letter. You can use the 
Apple-D command to delete the underline from 
the screen. 

4. Do not print your MouseText-ed documents. 


Printing MouseText involves using 
the procedures described last month 
to send MouseText Begin/End 
Commands to your printer. 
Although the on-screen and printed 
documents look similar, you must 
use different procedures to display 
and print MouseText. 

[Dr. Warren Williams is on the faculty 
at Eastern Michigan University where 
he teaches courses in the Educational 
Technology program. He is the Presi¬ 
dent ofNAUG and is a frequent con¬ 
tributor to the AppleWorlcs Forum.] 

[F. David Stephansky teaches comput¬ 
er courses for Fitchburg (MA) State 
College and the Plymouth County 
Education Association. You can reach 
Mr. Stephansky at 53 Simmons Ave., 
Whitman, Massachusetts 02382; (617) 447-5156.] 

[Clemesha’s AppleWorks Accessories Disk costs 
$4 (5.25-inch disk) or $6 (3.5-inch disk) plus $2 
s/h per order from NAUG. MouseText Maker is 
shareware; you send Dr. Clemesha $10 if you use 
the program after getting the disk from NAUG.] 
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Members Helping Members 


How to Get Help with Beagle Bros 
and JEM Products 


by Nanette Luoma 


Minnesota 


James Hirsch 


612-421-8393 612-422-5572 


Use this month’s list to find help with other Beagle 
Bros and JEM Software products. To the left of each 
volunteer’s name are numbers indicating the 
enhancements that consultant supports. 

1 = Companion Plus 7 = DoubleData 

2 = gs Font Editor 8 = FlexiCal 

3 = MacroEase 9 = Mr. Invoice 

4 = Outliner 10 = SpellCopy 

5 = Point to Point 11 = TotalControl 

6 = DBPix 


Montana- 

3,4,11 

Nevada 

1-5,7,11 

New Hampshire- 

3 Andy Albert 

New Jersey - 

4 Pete Crosta 

New Mexico — 

4 Paul Edwards 

New York - 


Steve Bernbaum 


406-373-6393 


Shepherd 


Keith Johnson 


702-626-2543 702-784-4812 


Bethlehem 


201-667-6369 201-677-4080 


Las Cruces 


505-525-2708 


Home 


Arizona— 

1,3,4,7 Cl 

California 

1,3,4,10,11 


Bob Beer 
Ira M. Garvin 
Gary C. Walters 


Coram 

Oakdale 

Hamburg 


516-928-6870 

516-563-1253 516-489-7620 

716-941-5442 


Tucson 


James P. Davis 
Cary Heilman 
Terence Higgins 
Will Nelken 
Robert M. Rowe 
Richard K. Stone 


Hayward 
Walnut Creek 
Newark 
San Rafael 
San Diego 
Northridge 


Jason Chao 


Cleveland Heights 216-321-5451 215-844-3791 


Oregon - 

1,3 JimEmig 

1 Richard Millus 

Pennsylvania — 

3,11 Claude W.Dav 

Rhode Island — 


503-771-1916 503-280-5676 

503-772-9787 


Portland 

Medford 


7,9,11 

Colorado - 

4 Lyle Grail 

Connecticut- 


Littleton 


Sandra Navarra 


Danbury 


203-743-3533 203-797-4778 


Richard A. Martone 
Don McCabe 


Warwick 

Saunderstown 


401-739-8698 

401-294-6256 508-636-2611 


Florida 


3,4 Ann Bennett 

1-5,7,10,11 Jeff Strichard 

Illinois - 


Orlando 407-843-0545 407-647-6366 

Ft. Lauderdale 305-587-9590 305-977-4991 


B.H. Hinshaw, Jr. 
Ramon F. Merlin 


817-274-2740 214-670-2119 

512-496-5331 


Arlington 
San Antonio 


Vermont - 

1,3,4,10,11 Douglas C. Corey 
11 John Nunnikhoven 

Virginia - 


Charles Jonaitis 


Wilmette 


Middlebury 

Weston 


802-388-6209 802-388-4021 

802-824-6286 


Indiana 


Jack Countryman Greensburg 


703-432-9230 703-433-8652 

804-340-6799 


Harrisonburg 
Virginia Beach 


Ft.Madison 


7,10 Wayne Sheffi 

Washington — 

1.2.5.6.9.11 Kent Hayden 

Wisconsin - 

1.3.7.8.11 


Louisiana 


Charles Fryling, Jr. Baton Rouge 504-766-3120 504-388-1473 


Tacoma 


206-566-9467 206-931-2669 


Maryland - 

1,3-5 Tony Mattern 

2-4,7 Michael Spurrk 

Massachusetts- 

1,4 Marie A. Barry 

Michigan - 

1-3,5 James T. Clark 


North East 
Baltimore 


Peter W. Lee 
Lucas Mikkelsen 
Scott Peterson 


Milwaukee 
Glen Flora 
Madison 


414-344-6807 

715-322-5633 

608-246-0762 


414-229-6180 

715-532-5511 


3,4,11 

Australia 


Beverly 


Caringbah, NSW 612-527-4731 612-524-3859 


Wyoming 


Paulo Chachamovich Porto Alegre 051-226-4358 051-225-4778 
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City Home Work 

Canada - 

1 Salvatore Latella London, Ont. 519-641-1510 

1.3.4.7.11 Jean Guy Mariage Montreal 514-922-4566 514-252-2541 

1 Trudy Young Toronto, Ont. 416-449-9400 

England - 

1.3.8.11 Andrew C. Letchford Crownhill, Plymouth0752-770-178 

France - 

1.2.5.6.11 Alain Zimmermann Palaiseau 1 69 31 07 64 1 49 78 02 88 


City Home Work 

Israel - 

1,3,10 Bernard Katz RamatAviv 03-642-3716 

Japan - 

5 Jack Thro Osaka 81-6-338-9163 81-6-586-3926 

New Zealand - 

3 Henry Harrison St. Lukes, Auk. 9 8469419 94861 491 

Switzerland - 

2 Charles Kubler Volketswil 01-945-5873 


New Disks in the NAUG Library 


Auto Works 

The NAUG Public Domain Library now includes Auto 
Works, a collection of templates that help you track 
your automobile expenses. Auto Works generates 
monthly and annual reports you can use to prepare 
expense reports for employers and reports to claim and 
substantiate business and charity-related income tax 
deductions. 

These easy-to-use templates come with complete docu¬ 
mentation in an Apple Works word processor file on the 
disk. 

The Auto Works templates are shareware; you send the 
author $5 if you use the templates on the disk. 

Russian Fonts 

NAUG members who prepare documents in Russian 
will appreciate NAUG’s new Russian Fonts Disk. This 
disk includes 12-point and 24-point Cyrillic fonts that 
you can use with SuperFonts, Apple Works GS, and 
other 8-bit and 16-bit applications that use standard 
Apple IIgs fonts. The disk also includes a keyboard 
map that will help Apple Works GS users type the vari¬ 
ous Cyrillic characters. NAUG’s Russian Fonts Disk 
also includes sample documents that you can print with 
SuperFonts or AppleWorks GS. 

Our thanks to William Davis for preparing the keyboard 
map and sample files on this disk. Mr. Davis also con¬ 
tributed the Hebrew Fonts Disk described in last 
month’s issue of the AppleWorks Forum. 

Sports Templates 

NAUG’s new Sports Templates disk includes templates 
for football, softball, and bowling enthusiasts. 

The football templates include 30 small data base files 
with data about all time record holders in scoring, rush¬ 


ing, passing, kicking, and in 23 other categories. The 
Football Forecaster on the disk helps you predict and 
track NFL statistics. A data base file on the disk includes 
information about all Indianapolis 500 race winners from 
1953 - 1988. A bowling template on the disk makes it 
easy to track individual scores and team bowling scores 
(but not league statistics). Finally, a softball template on 
the disk makes it easy to maintain softball team statistics. 

The Football Forecaster templates are “beggarware”; the 
author requests, but does not require, a $15 donation if 
you use the templates on the disk. The remaining tem¬ 
plates and files are freeware. 

We would appreciate hearing from the authors of the 
templates on this disk so we can recognize their contri¬ 
butions to the AppleWorks community. 

Yo-Yo Duck 

Yo-Yo Duck is a collection of diagnostic programs for 
Apple He, lie, lie Plus, and IIgs computers. The BASIC 
programs on this disk test your monitor, disk drives, 
cable connections, keyboard, speaker, memory, printer, 
and the sound capability of your system. A utility on the 
disk also makes it easy to use a disk cleaner to clean 
your disk drives. 

Yo-Yo Duck includes complete documentation in an 
AppleWorks word processor file on the disk. The pro¬ 
gram is shareware; you send the author $5 if you use the 
utilities on the disk. 

How to Get Disks 

Unless otherwise noted, all disks are available in both 
5.25-inch ($4) and 3.5-inch ($6) format, plus $2 s/h per 
order. Order from: Public Domain Library, NAUG, Box 
87453, Canton, MI 48187; (313) 454-1115; Fax: (313) 
454-1965. NAUG accepts Visa and MasterCard. 
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Electronic Index Update - October 

Enter the default values for these categories: 

Volume #: 7 • Issue #: 10 • Date: Oct 92 

Software Review • 2 • TimeOut Grammar Can Improve Your Writing • Katz, 
Howard • Grammar; Grammar Checker; AppleWorks 3.0; TimeOut; Quality 
Computers; word processor 

General Interest • 7 • Now an Even Faster Apple IIgs • Link, John • Apple IIgs; 
TransWarp GS; ZipGS; TWGS Reporter Disk; accelerator; Western Design 
Center; Digi-Key Corporation; speed; hardware 
UltraMacros Primer • 11 • Converting Your Macros for Ultra 4 • Munz, Mark • 

Ultra 4; UltraMacros; macros; programming 
UltraMacros Primer • 14 • How to Shorten Your Macros • Munz, Mark • Ultra 4; 
UltraMacros; macros 

AppleWorks News • 15 • News and Special Offers for NAUG Members • N/A • 
NAUG; Apple Expo East; Seniors Helping Seniors 
Educational Applications • 17 • Play “AppleWorks Jigsaw Puzzle" • Shapiro, Phil 
• word processor; education; puzzles; games 
AppleWorks News • 18 ♦ News and Special Offers for NAUG Members • N/A • 
Bemak Enterprises; templates; sports; golf; bowling 
My Favorite Template • 19 • A Gradebook Template - Part One • Hecker, Stan • 
gradebooks; education; templates; spreadsheet; @OR; @IF 
AppleWorks News • 23 • News and special offers for NAUG Members • N/A • 
JEM Software; TotalControl; DoubleData; DB Pix 
My Favorite Macro • 24 • How to Use UltraMacros Subroutines • Johnson, Keith • 
UltraMacros; macros; Ultra 4; programming 
Word Processor Tips • 26 • How to Enhance Your Documents with MouseText - 
Part Two • Williams, Warren; Stephansky, F. David • MouseText; word proces¬ 
sor; AppleWorks 3.0; printing; printing effects 
Members Helping Members • 30 • How to Get Help with Beagle Bros and JEM 
Products • Luoma, Nanette • Companion Plus; GS Font Editor; MacroEase; 
Outliner; Point to Point; DB Pix; Double Data; FlexiCal; Mr. Invoice; Spell- 
Copy; TotalControl 

Public Domain Update • 31 • Two New Disks in the NAUG Library • N/A • Auto 
Works; Sports Templates; public domain; sports; football; softball; bowling; 
foreign languages; Russian Fonts; Yo-Yo Duck 
New Keywords: Auto Works; Bemak Enterprises; bowling; Digi-Key Corpora¬ 
tion; football; games; golf; puzzles; Russian Fonts; Seniors Helping Seniors; 
softball; sports; Sports Templates; Ultra 4; Yo-Yo Duck 
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